From f65bd343b074358ce3222e9aebd70908d0362f25 Mon Sep 17 00:00:00 2001 From: Keir Fraser Date: Mon, 12 Jul 2010 18:39:18 +0100 Subject: [PATCH] sysctl: Another clarification re. max_cpu_index. Signed-off-by: Keir Fraser --- xen/include/public/sysctl.h | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/xen/include/public/sysctl.h b/xen/include/public/sysctl.h index 71edbf5340..d35237a5e7 100644 --- a/xen/include/public/sysctl.h +++ b/xen/include/public/sysctl.h @@ -468,17 +468,17 @@ struct xen_sysctl_topologyinfo { * IN: maximum addressable entry in the caller-provided arrays. * OUT: largest cpu identifier in the system. * If OUT is greater than IN then the arrays are truncated! + * If OUT is leass than IN then the array tails are not written by sysctl. */ uint32_t max_cpu_index; /* - * If not NULL, this array is filled with core/socket/node identifier for - * each cpu. + * If not NULL, these arrays are filled with core/socket/node identifier + * for each cpu. * If a cpu has no core/socket/node information (e.g., cpu not present) - * then the sentinel value ~0u is written. - * The size of this array is specified by the caller (@max_cpu_index+1). - * If the array has more than @max_cpu_index+1 elements then the trailing - * elements of the array will not be written by the sysctl. + * then the sentinel value ~0u is written to each array. + * The number of array elements written by the sysctl is: + * min(@max_cpu_index_IN,@max_cpu_index_OUT)+1 */ XEN_GUEST_HANDLE_64(uint32) cpu_to_core; XEN_GUEST_HANDLE_64(uint32) cpu_to_socket; -- 2.30.2